メールでBacklogに課題を登録してみた

メールでBacklogに課題を登録してみた

Clock Icon2023.05.15

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

データアナリティクス事業本部の鈴木です。

Backlogで障害用の課題などを起票する際に、障害通知から自動的に課題が起票されると便利ですよね。

Backlogでは課題をメール経由で登録でき、とても簡単に登録用メールアドレスを払い出せることを知ったので、以下のページを参考に自分で試してみた内容をご紹介します。

メールによる課題登録を設定する

やりたいこと

障害発生時にシステムからBacklogにメールを送信して自動的に課題を登録したいです。

自動登録にあたって、特に以下を確認しました。

  • 後から課題を種別ごと(障害など)に管理ができるよう、種別カテゴリは設定できるか
  • 期限日が設定できるか
  • 課題テンプレートとメールの内容のどちらが優先されるか

なお、この機能は2016年より以前からある機能で、DevelopersIOでも記事がありました。当時と若干UIが変わっていたのも確認できたので、改めて自分でも検証してみました。

また、本検証はASPサービス版の内容になります。

前提

作業ユーザー

Backlogプロジェクトのプロジェクト管理者で作業を行うこととします。

後ほどご紹介しますが、この設定はプロジェクト設定インテグレーションから行います。

記事執筆時点では仕様が異なる新プランおよびクラシックプランがありますが、いずれも管理者およびプロジェクト管理者のみプロジェクトの編集権限があります。

ユーザーの権限 – Backlog ヘルプセンター

自分が何の権限を持っているか知りたい場合は、プロジェクト設定参加ユーザーから確認できます。

プロジェクト管理者の設定 – Backlog ヘルプセンター

課題テンプレート

今回は既にテンプレートが設定されているTaskの種類の課題をメールから作成してみました。

テンプレート設定1

Taskの種類には、以下のように課題テンプレートが設定されています。

テンプレート設定2

やってみる

1. メールによる解題登録の設定

まずプロジェクト設定インテグレーションから、インテグレーションの一覧を開きました。

メールによる課題登録の設定1

下の方にスクロールすると、メールによる課題登録があるので設定を押しました。

メールによる課題登録の設定2

設定タブの課題登録用メールアドレスの追加を押しました。

メールによる課題登録の設定3

設定画面が開くので必須項目を設定していきました。

今回は以下を設定し、ほかはデフォルト設定にしました。

  • 設定名
  • 課題の登録者
  • 種類

メールによる課題登録の設定4

メールによる課題登録の設定5

メールによる課題登録の設定6

※ 画面例は元々は同一画面ですが、縦に長かったので分割して掲載しています。繋がりが分かりやすいように一部同じ欄がうつるようにしました。

種別カテゴリ期限日などが登録できることが分かります。

登録を押すと、以下のように課題登録用のメールアドレスが払い出されました。

課題登録用のメールアドレス

2. メールの送信

課題登録用のメールアドレスにメールを送信してみました。

今回は以下のようなメールを送信しました。

メール例

3. 登録された課題の確認

しばらく待って、課題がどのように登録されたか確認しました。

登録された課題

件名が課題名、メール本文が詳細に記載されました。

Taskの種類には課題テンプレートを登録していましたが、メール本文で上書きされてしまいました。この機能を使う場合は課題テンプレートと併用はできなさそうです。

補足

メール本文がない場合の課題登録

メール本文が課題の詳細に記載されるためテンプレートと併用できなかった例を記載しましたが、メール本文が空の場合はどうなるのかも確認しました。

以下のように本文が空のメールを送ってみました。

本文が空のメール

結果としては、課題の詳細が空になるだけで、やはり課題テンプレートとは併用できないようでした。

本文が空のメールで作成した課題

よりカスタマイズした課題を自動で作成したい場合は以下のようなAPIを使ったプログラムを作成することになりそうです。

最後に

今回はBacklogのメールによる課題登録の機能を使って、メール送信によりBacklog課題を登録する際の設定と例をご紹介しました。

参考になりましたら幸いです。

Share this article

facebook logohatena logotwitter logo

© Classmethod, Inc. All rights reserved.